home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 471 / applic / studio.doc < prev    next >
Text File  |  1990-05-18  |  8KB  |  230 lines
  1.                           Sprite Studio
  2.  
  3.      Sprite  Studio is a low-res painting program written  in  GFA 
  4. Basic  that incorporates several non-standard features  useful  in 
  5. creating sprites for animations as well as games.   Sprite  Studio 
  6. also has the ability to load any file as graphics (not just  DEGAS 
  7. or  Neochrome  pictures).   Each of the  program's  functions  are 
  8. detailed below.
  9.  
  10. Getting Started
  11.  
  12.      Double-click   on   the   file STUDIO.PRG.  When   the groovy 
  13. title screen appears, click the mouse to begin.
  14.  
  15. The Menu
  16.  
  17.      Sprite  Studio  is fully icon-driven.   All  of  the  program 
  18. functions  are  shown on one of two menus.   The default  menu  is 
  19. a rectangle five icons wide and four icons tall.  You can also use
  20. a menu  that  is one icon tall and twenty icons wide (More on this 
  21. later).  The descriptions of each menu item follow.
  22.  
  23. Disk 
  24.      Controls  the  loading  and saving  of  picture  files.   Two 
  25.      standard  picture types are available,  Degas and  Neochrome.  
  26.      You can  also  choose to load a file as  raw  graphics  data.  
  27.      With this option,  you can load any file you wish, from games 
  28.      to  text  files (although I can't see what good a  text  file 
  29.      would be to a paint program).
  30.  
  31. Draw
  32.      Allows you to draw freehand.
  33.  
  34. Fill
  35.      Allows  you  to pick one of the thirty-six standard  ST  fill 
  36.      patterns.  There are no user-defined fill patterns.
  37.  
  38. Airbrush
  39.      'Nuff said. 
  40.  
  41. Palette
  42.      This is actually another menu in itself, allowing the user to 
  43.      choose or define a color in the palette.
  44.  
  45. Frame
  46.      This creates open rectangles.
  47.  
  48. Box
  49.      This creates filled rectangles.
  50.  
  51. Circle
  52.      This creates open circles (no ovals).
  53.  
  54. Disc
  55.      This creates filled circles.
  56.  
  57. Magnify (The icon that most closely resembles a microscope)
  58.      Magnifies   a  thirty-two  by  fourty  pixel  area   of   the 
  59.      workscreen.
  60.  
  61. Line
  62.      Draws lines.
  63.  
  64. Text 
  65.      Allows  you  to choose four different sizes of  the  standard 
  66.      system font.   Text is then entered from the keyboard and may 
  67.      be placed anywhere on the workscreen.
  68.  
  69. Line Size
  70.      Allows you to choose from eight different line  sizes.   This 
  71.      affects the draw,  airbrush,  frame,  box,  circle, disc, and 
  72.      line functions.  
  73.  
  74. Move Screen (The funny-looking icon with four arrows.)
  75.      This allows you to scroll vertically and horizontally through 
  76.      a picture that is larger than a standard picture  file.   The 
  77.      arrow keys  control direction and holding down the shift  key 
  78.      while using the arrows will make it scroll faster.
  79.  
  80. Block
  81.      This allows you to cut out a rectangular block of the  screen 
  82.      in either opaque or transparent mode. To copy a block between 
  83.      workscreens, cut out the block and press the space bar.
  84.    
  85. Sprite (The funny-looking icon that resembles Tinkerbell.)
  86.      This  function has a menu of it's own.   The descriptions  of 
  87.      these items follow.
  88.      
  89.      Append
  90.           This  allows  you  to cut out  a  sprite  from  the 
  91.           current workscreen and append it to the end of  the 
  92.           current list of sprites.  A sprite file can contain
  93.           320 sprites.
  94.  
  95.      Insert
  96.           This allows you to pick a place to insert a  sprite 
  97.           into the current list.   To move through the  list, 
  98.           move the mouse left and right.  When you are at the 
  99.           spot  you want,  click the left button and cut  out 
  100.           the sprite to insert.
  101.  
  102.      Delete
  103.           Allows  you  to  choose a sprite  using  the  above 
  104.           method to delete from the list.
  105.  
  106.      New
  107.           Erases ALL sprites in memory.
  108.  
  109.      Browse
  110.           This  allows  you to look at the  current  list  of 
  111.           sprites using the mouse.
  112.  
  113.      Capture
  114.           Copies  a  sprite  from  the  sprite  area  onto  a 
  115.           workscreen for editing.
  116.  
  117.      File
  118.           Allows   you  to  load  and  save   SPRITE   STUDIO 
  119.           compatible  sprite  files.   When saving  a  sprite 
  120.           file,  you  can  elect  to include  masks  for  the 
  121.           sprites  or  leave them out (Note  that  masks  are 
  122.           needed for transparent animations).  Details of the 
  123.           format  of  a sprite file are at the  end  of  this 
  124.           document.
  125.  
  126.      Test Animation
  127.           This animates the sprites so as to give you an idea 
  128.           of what your sprites will look like in action.         
  129.  
  130. Grid
  131.      This allows you to instantly draw a grid of any size  on 
  132.      the current workscreen.
  133.  
  134. Erase
  135.      This erases the current workscreen in one fell swoop.
  136.  
  137. Change Menu
  138.      This  changes  the  box menu to the bar  menu  and  back 
  139.      again.
  140.  
  141. Change Screen
  142.      This toggles between the two available workscreens.
  143.  
  144.  
  145. Additional Program Notes:
  146.  
  147.      Pressing  the  right mouse button will usually allow  you  to 
  148.      exit any function without affecting the workscreen.
  149.  
  150.      Menus  can  be moved anywhere on the screen by  clicking  the 
  151.      left  mouse button outside the menu at the location you  want 
  152.      it to occupy.   This allows you to see the picture while  you 
  153.      decide which function you wish to use.
  154.  
  155.      The  file  "STUDIO.SPR"  must  be  in  the  same  folder   as 
  156.      "SPRITE.GFA"
  157.  
  158.      Files other than Degas or Neochrome format may not be  loaded 
  159.      into workscreen two.
  160.  
  161.      Only  one palette can be active at a time in  Sprite  Studio.  
  162.      The  palette used will be the palette of the last picture  or 
  163.      sprite file loaded.
  164.  
  165. ********************* -- Updates in V1.5 -- **********************
  166.  
  167. Version 1.5, in addition to some minor changes, now includes a way 
  168. to set default values for fill pattern, line width, text size, and 
  169. block type (transparent or opaque).  To invoke this function, just 
  170. press the right mouse button while on the main menu.   A  sub-menu 
  171. will appear.   The buttons on this menu and their functions are as 
  172. follows:   Left-most,  small  button - turns defaults mode on  and 
  173. off.   Fill - allows selection of a default fill pattern.   Line - 
  174. selects  default  line size.   Text - selects default  text  size.  
  175. Blok - selects default transparency or opacity of blocks.
  176.  
  177. ******************************************************************
  178.  
  179.  
  180.  
  181. Sprite file format
  182.  
  183.      The  Sprite  Studio  sprite file format  is  detailed  below.  
  184. Also, routines for loading a sprite file in GFA Basic follow.
  185.  
  186.      The  first item in a sprite file is the mask flag.   It is  a 
  187. number  followed  by a CR/LF.   If it is a  zero,  masks  are  not 
  188. present.   If it is a one, a mask follows each sprite in the file.  
  189. The next item is the number of sprites in the file.   It is also a 
  190. number  followed  by CR/LF.  The next thirty-two bytes  contain  a 
  191. standard  sixteen-color  palette using one word to  describe  each 
  192. color.   (Example:  $0777 for white.)  Next are the actual sprites 
  193. with their masks.  The first two bytes of each sprite or mask tell 
  194. how long each one is in bytes.
  195.  
  196. A GFA Basic routine for loading a sprite file looks like this:
  197.  
  198. OPEN "I",#1,"sprites.spr"
  199. INPUT #1, mask%
  200. INPUT #1, numsprites%
  201. palette$=input$(32,#1)
  202. FOR loop=0 TO 15
  203.    SETCOLOR loop,CVI(MID$(palette$,loop*2+1,2))
  204. NEXT loop
  205. FOR loop=1 TO numsprites%
  206.    sprite$(loop)=INPUT$(CVI(INPUT$(2,#1)),#1)
  207.    IF mask% = 1 THEN
  208.       mask$(loop)=INPUT$(CVI(INPUT$(2,#1)),#1)
  209.    ENDIF
  210. NEXT loop
  211.  
  212.      Of course, you have to dimension Sprite$() and Mask$() to the 
  213. proper  sizes  or you will get an "ARRAY NOT  DIMENSIONED"  error.  
  214. Also, if you are using Sprite Studio sprites with a language other
  215. than  GFA  Basic,  your sprites should be a  multiple  of  sixteen 
  216. pixels  wide  in order to use VDI routines to  display  them.   To 
  217. display  your sprites with GFA Basic,  use "PUT  x,y,sprite$"  for 
  218. opaque  and "PUT x,y,mask$,4" followed by "PUT x,y,sprite$,6"  for 
  219. transparent. 
  220.  
  221. If  you have  any  questions  involving GFA  Basic  and the use of 
  222. sprites, feel free to write to me at:
  223.  
  224.                          Cory Chapman
  225.                          4337 W Bethany Home Road
  226.                          Phoenix, AZ  85301  (USA) 
  227.  
  228. P.S.   Be  sure to enclose a self-addressed stamped envelope  with 
  229. the proper postage.
  230.